home *** CD-ROM | disk | FTP | other *** search
/ Microsoft Multimedia Viewer How-To CD / Microsoft Multimedia Viewer How-To CD.iso / readme.txt < prev    next >
Text File  |  1993-03-21  |  14KB  |  339 lines
  1.  
  2. README FOR DEMONSTRATION MULTIMEDIA VIEWER PUBLISHING TOOLKIT 2.0
  3. ---------------------------------------------------
  4.  
  5.  
  6. PTK SETUP
  7. =========
  8.  
  9. This section provides more information about the SETUP program in the
  10. Viewer 2.0 Publisher's Toolkit.
  11.  
  12. INSTALLING OVER A BETA INSTALLATION
  13. -----------------------------------
  14. If you have installed a Beta release of Multimedia Viewer, it is
  15. recommended that you remove the Multimedia Viewer PTK program group
  16. before you install the current release of Viewer. Otherwise, the Viewer
  17. SETUP program installs a new, duplicate icon for the Viewer Gallery.
  18.  
  19. COPYING NEW VERSIONS OF FILES
  20. -----------------------------
  21. If you reinstall the Viewer PTK over an existing installation and Setup
  22. finds existing files with the same date/time stamp in the directory to
  23. which you're installing, it does not display "Copying file..." messages
  24. for the files it installs over the existing files. (You will notice
  25. activity on your hard disk while Viewer installs the files from the
  26. CD-ROM.)
  27.  
  28. GRAPHICS FILTERS INSTALLED WITH VIEWER 2.0
  29. ------------------------------------------ 
  30. To ensure the correct operation of the Convert tool, the Viewer 2.0
  31. SETUP program installs versions of the standard graphics filters
  32. supplied with other Microsoft applications (including Word for Windows
  33. and PowerPoint).  It installs these filters if you install the
  34. Multimedia Viewer authoring tools, but only if it detects that the
  35. filters provided in the Viewer 2.0 PTK have more recent version numbers
  36. than the filters on your machine.
  37.  
  38. If you have other versions of these filters on your machine, the
  39. WIN.INI file may contain entries for these filters that point to
  40. directories other than the MSAPPS\GRPHFLT subdirectory of your Windows
  41. directory.  (These entries are in the [MS Graphic Import Filters] and
  42. [MS Graphic Export Filters] sections of WIN.INI.) The Viewer 2.0 SETUP
  43. program does not change these WIN.INI entries. If these entries cause
  44. problems when you try to run Convert or other applications that use the
  45. filters, remove them and then reinstall the authoring tools for the
  46. Viewer 2.0 PTK.
  47.  
  48.  
  49. DEVICE INTERACTIONS
  50. ===================
  51.  
  52. This section describes devices and device drivers that are known to
  53. cause problems with Viewer 2.0.
  54.  
  55. VIDEO PROBLEMS
  56. --------------
  57. In some situations, Viewer titles may encounter video display problems
  58. when using high resolution video drivers from various video card
  59. manufacturers.  This problem can often be fixed by obtaining updated
  60. drivers from your video card manufacturer.  Make sure the video drivers
  61. you are using were designed to be compatible with Microsoft Windows
  62. version 3.1.
  63.  
  64. Contact the manufacturer of  your video card for updated Windows display
  65. drivers.  Their phone number should be in the manuals that came with
  66. your video card or personal computer.  Another option for obtaining
  67. updated drivers is the Microsoft Download service, an electronic
  68. bulletin board that can be accessed via a modem at (206) 936-MSDL (6735).
  69.  
  70. Drivers provided on the Microsoft Supplemental Driver Library (MSDL) are
  71. compressed with the PKWare utilities, and are in the form of executable
  72. files (.EXE extension).  It is best to download the file or files you
  73. need into an empty directory on your hard disk, or to a blank formatted
  74. floppy. To decompress these drivers after downloading them, either:
  75.  
  76. >From Windows File Manager:  double click on the filename (e.g.,  the
  77.  appropriate file ending in .EXE) that you downloaded; or,
  78.  
  79. >From the DOS prompt:  change to the directory containing the downloaded
  80.  file, type the filename, and press ENTER;
  81.  
  82. An alternative to obtaining a new or updated display driver is to
  83. change your video mode to a standard video mode such as 640 x 480
  84. resolution, with as many colors as your video card can support at that
  85. resolution.  To use your title while waiting for an updated video
  86. driver from your video card manufacturer, you can use the standard VGA
  87. driver that comes with Windows.  This display mode is only 16 colors
  88. and some images may not look as well as they would in 256 colors. Also,
  89. image display takes slightly longer when running in 16 color mode.  For
  90. instructions on installing the standard VGA driver, please see Help
  91. within Windows Setup in the Main program group in the Program Manager.
  92.  
  93. ATI ULTRA GRAPHICS ADAPTER
  94. --------------------------
  95. You may encounter problems in Viewer titles if you are not using the
  96. most current video driver for the ATI Ultra graphics adapter. Some of
  97. the problems known to be caused by earlier versions of the driver
  98. include:
  99.  
  100.     - Displaying TrueType fonts larger than 20 points incorrectly
  101.  
  102.     - Repainting the desktop bitmap incorrectly after closing a title
  103.  
  104.     - Problems creating hot spots in 2-color bitmaps in Hotspot Editor
  105.  
  106.     - Banding problems in bitmaps when displayed in 1,024-by-768 mode
  107.  
  108.     - Problems displaying certain extended characters on the menu bar
  109.  
  110. See the previous section, "Video Problems," for more information about
  111. obtaining updated versions of the device driver for this video adapter.
  112.  
  113. PRINTERS THAT USE UNIDRV.DLL
  114. ----------------------------
  115. Some printers require the installation of a DLL named UNIDRV.DLL.
  116. Printers that use this DLL may encounter problems when printing topics
  117. from Viewer titles.
  118.  
  119. To work around this problem, choose Print Setup and clear the Color 
  120. check box (ordinarily, this box is checked during the default setup.)
  121.  
  122. DEC ETHERWORKS TURBO /TP NETWORK ADAPTER
  123. ----------------------------------------
  124. Problems may arise when you compile a title over a network using the
  125. DEC Etherworks Turbo /TP network adapter.
  126.  
  127.  
  128. VIEWER COMPILER
  129. ===============
  130.  
  131. This section provides additional information about the Viewer compiler
  132. and indexer.
  133.  
  134. ERROR MESSAGES
  135. --------------
  136. Error 8041, "Entry/Exit macro specification overflow," may also indicate
  137. that the project file includes too many topic groups.
  138.  
  139.  
  140. AUTHORING AND AUTHORING TOOLS
  141. =============================
  142.  
  143. This section provides additional information about authoring subjects,
  144. including authoring tools such as Project Editor, Topic Editor, and
  145. Hotspot Editor.
  146.  
  147. PARAGRAPH FORMATTING IN POPUP TOPICS
  148. ------------------------------------
  149. Right paragraph margins are ignored in popups. To create right-side
  150. white space in a popup, enclose the topic paragraphs in a table (the
  151. right margin values of the paragraphs in the tables will be used).
  152.  
  153. FIELD STATEMENTS IN NONSCROLLING PARAGRAPHS
  154. -------------------------------------------
  155. By default, text in nonscrolling paragraphs (formatted Keep With Next)
  156. are assigned field value 1. You can assign different field values
  157. (using {vfld} statements) to text in nonscrolling regions. However,
  158. doing this excludes the text from "Topic Titles Only" searches.
  159.  
  160. LIMITS ON TOPIC-ENTRY COMMAND FOOTNOTES
  161. ---------------------------------------
  162. Topic-entry commands for a topic have a combined limit of 512
  163. characters. 
  164.  
  165. XA FILE NAMES FOR SONY PLAYER TITLES
  166. ------------------------------------
  167. In titles for the Sony Multimedia CD-ROM Player, filenames for XA
  168. streams cannot begin with a pound sign (#). Using this character may
  169. interfere with playback of the XA stream because the Mammoth player
  170. interprets this character as a "resume" command rather than part of the
  171. filename.
  172.  
  173. USING #IGNORE AND #ENDIGNORE STATEMENTS IN PROJECT EDITOR
  174. ---------------------------------------------------------
  175. As noted in pages 12-10 and 12-11 of the Authoring Guide, you can
  176. type #ignore and #endignore statements as entries in the RTF and
  177. Baggage cards in Project Editor. These statements comment out a 
  178. series of filenames located between the #ignore and #endignore
  179. statements.
  180.  
  181. EXERCISE CAUTION WHEN USING THESE STATEMENTS IN PROJECT EDITOR! As
  182. noted in the Authoring Guide, you MUST include a matching #endignore
  183. statement for any #ignore statement.
  184.  
  185. If you type a #ignore statement without a matching #endignore
  186. statement, and then save the project file, Project Editor will assume
  187. that everything following the #ignore statement (including material
  188. outside the [FILES] or [BAGGAGE] section) is to be ignored. When you
  189. reopen the .MVP file in Project Editor, you might see the contents of
  190. other project file sections moved into the RTF or Baggage cards. Also,
  191. Project Editor will attempt to recreate the missing sections by adding
  192. empty (and duplicate) entries. If this happens, you'll need to open the
  193. project file in Word and manually fix the errors.
  194.  
  195. CITATION IN [OPTIONS] - TITLE OPTIONS DIALOG BOX
  196. ------------------------------------------------
  197. Project Editor lets you type a SHIFT+ENTER keystroke when typing the
  198. citation text. However, this writes a newline character to the project
  199. file, resulting in a project-file error (compiler error 2131, Invalid
  200. Options Syntax). Do not press SHIFT+ENTER when editing this field.
  201.  
  202. BUILD EXPRESSION IN [OPTIONS] - COMPILER OPTIONS DIALOG BOX
  203. -----------------------------------------------------------
  204. Project Editor lets you type a SHIFT+ENTER keystroke when typing the
  205. build expression. However, this writes a newline character to the 
  206. project file, resulting in a project-file error (compiler error 2131,
  207. Invalid Options Syntax). Do not press SHIFT+ENTER when editing this
  208. field.
  209.  
  210. CLOSE SOURCE FILES BEFORE COMPILING
  211. -----------------------------------
  212. Before compiling a title from Project Editor, be sure to close all
  213. source files. If .RTF files are still open in Word, your title will
  214. fail to compile.
  215.  
  216. COMMAND PARAMETER EDITING
  217. -------------------------
  218. When editing string parameters in the edit command dialog box, Topic
  219. Editor highlights the parameters, including the quotes ( ` and ' ).
  220. When typing in a new string parameter, be sure to include the required
  221. quotes.
  222.  
  223. WINDOWS, PANES, AND POPUPS LIMITATION
  224. -------------------------------------
  225. The maximum number of windows, panes, and popups that Project Editor
  226. allows you to define is approximately 153 total (windows, panes, and
  227. popups combined). However, the actual Viewer limit is 255 for each
  228. type: 255 windows, 255 panes, and 255 popups. If you wish to define
  229. more windows, panes, and popups than Project Editor will allow, edit
  230. the .MVP file without using Project Editor. 
  231.  
  232.  
  233. VIEWER RUNTIME AND DLLS
  234. =======================
  235.  
  236. This section provides additional information about the Viewer runtime
  237. (MVIEWER2.EXE) and its associated search and multimedia DLLs.
  238.  
  239. RUNNING VIEWER TITLES UNDER WINDOWS 3.0
  240. --------------------------------------- 
  241. The standard Search dialog box is not supported under Windows 3.0. You
  242. can write your own custom search interface. 
  243.  
  244. Also, the French and German versions of the Viewer runtime files do not
  245. support Windows 3.0.
  246.  
  247. VIEWER EDIT/COPY COMMAND
  248. ------------------------
  249. The Copy command on Viewer's Edit menu immediately copies text to the 
  250. Clipboard. Users do not need to choose the OK button. As a result, this
  251. command overwrites the current contents of the Clipboard whenever users
  252. select it. The Viewer command CopyDialog() has the same effect.
  253.  
  254. SEARCH HITS IN TABLES
  255. ---------------------
  256. Search hits may be incompletely highlighted if they appear in the last
  257. column of a table and when the paragraph in which the word appears is
  258. the first in its row.
  259.  
  260. WORD STEMMING ON 80286-BASED MACHINES
  261. -------------------------------------
  262. If your title will be run on 80286-based machines, do not use word
  263. stemming. 
  264.  
  265. USING METAFILES WITH VIEWER 2.0
  266. -------------------------------
  267. Viewer 2.0 can display metafiles created by the filter programs in Word
  268. for Windows 2.0. The Convert utility uses these same filters, so
  269. metafiles created by Convert can be used with Viewer 2.0.
  270.  
  271. Older versions of some applications create metafiles in a format
  272. incompatible with Viewer 2.0. These metafiles may also cause problems
  273. with other programs in the Viewer 2.0 package (for example, with
  274. Hotspot Editor).
  275.  
  276. If a metafile causes problems when you try to build or display a Viewer
  277. title, convert it to standard DIB format. Converting metafiles to DIB
  278. format also may improve display performance in the title.
  279.  
  280. Metafiles with palettes cannot be displayed using {bmx} commands.
  281.  
  282. MCI BAGGAGE FILES IN WINDOWS NT
  283. -------------------------------
  284. Viewer 2.0 has not been fully tested on Windows NT. Viewer titles that
  285. are viewed under Windows NT cannot open MCI files (such as waveforms or
  286. Video for Windows files) that are stored in baggage. Viewer titles that
  287. will be displayed on NT should store all MCI files external to the .MVB
  288. file.
  289.  
  290. PLAYING VIDEO FOR WINDOWS FILES
  291. -------------------------------
  292. The driver necessary to play .AVI files is included in this package. 
  293. You may ship this driver with your title.  However, you must purchase
  294. Microsoft Video for Windows to obtain the tools necessary to prepare
  295. .AVI files.
  296.  
  297.  
  298. CREATING VIEWER TITLE SETUPS
  299. ============================
  300.  
  301. This section lists notes about creating setup programs for titles and
  302. the Viewer 2.0 files you can include with your titles.
  303.  
  304. EXTENDED CHARACTERS IN TITLE.MST FILE
  305. ------------------------------------- 
  306. In the TITLE.MST file, extended characters cannot be used in the names
  307. assigned to ProgManGroup$ or ProgManItem$. Extended characters used
  308. this way may not appear as part of the group name or item name when
  309. SETUP creates the program group and adds the title to the group. 
  310.  
  311. FILES YOU CAN DISTRIBUTE WITH VIEWER TITLES
  312. -------------------------------------------
  313. You can modify any of the following files provided with Viewer 2.0 and
  314. ship them as part of your own titles:
  315.  
  316. mvhlpusa\*.*
  317. mvhlpfrn\*.*
  318. mvhlpger\*.*
  319.  
  320. mvsample\progsamp\setup\*.*
  321. mvsample\progsamp\eplist\*.*
  322. mvsample\progsamp\katasrch\*.*
  323.  
  324. You can ship any of the following files as part of a Viewer for Windows
  325. title:
  326.  
  327. mvsysusa\*.*
  328. mvsysfrn\*.*
  329. mvsysger\*.*
  330.  
  331. You can ship the following files with Viewer titles for the Sony MMCD
  332. Player only with a licensing agreement from Microsoft; see the
  333. application enclosed in the Viewer 2.0 PTK for details:
  334.  
  335. mvsony\exeme.exe
  336. mvsony\viewer.vid
  337.  
  338.  
  339.